home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 November / CHIP Kasım 1998.iso / emulators / atari2600 / z26v113x.exe / README.TXT next >
Text File  |  1998-09-22  |  15KB  |  414 lines
  1.  
  2. z26 -- An Atari 2600 Emulator (1.13) -- Sep 22, 1998
  3. ----------------------------------------------------
  4.  
  5. Copyright (C) 1997-1998 by John Saeger
  6.  
  7. Home Page:  http://www.whimsey.com/z26
  8.  
  9. Send EMAIL to:  john@whimsey.com
  10.  
  11.  
  12. What's New in this version?
  13. ---------------------------
  14.  
  15. 1.  Fixed column blanking. (broken in 1.12).
  16. 2.  Fixed icehocky. (broken in 1.10).
  17.  
  18. For a complete history of the versions please visit:
  19.  
  20. http://www.whimsey.com/z26/z26FAQ.html
  21.  
  22.  
  23. Introduction
  24. ------------
  25.  
  26. z26 is a small, fast, easy to use Atari 2600 emulator that runs on a DOS
  27. platform, including Windows 95 and Windows 98 DOS boxes. z26 supports 
  28. full Atari 2600 sound emulation using a Sound Blaster.
  29.  
  30.  
  31. System Requirements
  32. -------------------
  33.  
  34. z26 will run at full speed on virtually any Pentium class platform with
  35. a reasonable (PCI or better) video subsystem. It also runs fine on most
  36. AMD 5x86 or Cyrix 5x86 machines (with VLB video), and even on some fast
  37. 486's.
  38.  
  39. z26 supports the use of a Sound Blaster card. It requires a Sound
  40. Blaster with at least version 2.00 DSP. This includes SB 2.0, SB-PRO,
  41. SB-16, and SOME older Sound Blasters. It should also run on more recent
  42. models of Sound Blaster, and many clones as well. I've heard it works on
  43. an Ensoniq PCI sound card.
  44.  
  45. If you don't have a Sound Blaster or a compatible sound card, z26 will
  46. make an attempt to use the PC speaker to generate sounds. Try not to
  47. expect too much from the speaker though.
  48.  
  49.  
  50. Newbies
  51. -------
  52.  
  53. Now that you have z26, the next thing you need to do is find the ROM images.
  54. These are the actual games.  z26 is not a game, z26 just lets you play them.
  55. So go to my links page:
  56.  
  57. http://www.whimsey.com/z26/z26Links.html 
  58.  
  59. and follow some of the links that have (ROMS) next to them.  I can't say
  60. exactly where on these sites you'll find them but I've found them 
  61. on these sites in the past.  After you get them you'll need to unzip them.
  62. They'll be in a file with a .ZIP extension.  So you'll need PKUNZIP or some
  63. other unzipping utility to extract the ROM images from the .ZIP file.  The
  64. actual ROM images have a .bin extension.  So after you get the .bin files
  65. into the same directory as z26, open a DOS box (if you're not already
  66. in one or running DOS) and follow the next step... Startup.
  67.  
  68.  
  69. Startup
  70. -------
  71.  
  72. At the command line prompt type:
  73.  
  74. >z26 filename
  75.  
  76. where filename is the name of a "standard" Atari 2600 .bin file. For
  77. example: 
  78.  
  79. >z26 demonatk.bin
  80.  
  81. will run Demon Attack. You're on your own finding the .bin files. But if
  82. you follow the links on the z26 links page, eventually you may get lucky.
  83.  
  84.  
  85. Getting Help
  86. ------------
  87.  
  88. If you type
  89.  
  90. >z26
  91.  
  92. without a filename you get a short help screen describing the available
  93. controls and some command line options. The screen currently looks like this:
  94.  
  95.  
  96. z26 -- An Atari 2600 emulator (1.12)
  97. Copyright (C) 1997-1998 by John Saeger
  98. Home Page:  http://www.whimsey.com/z26
  99.  
  100.     F1 -- reset      F2 -- select     F3 -- B/W        F4 -- Color
  101.     F5 -- P0 easy    F6 -- P0 hard    F7 -- P1 easy    F8 -- P1 hard
  102.      p -- pause   ENTER -- resume    ESC -- quit        = -- PCX screen capture
  103.   PgUp -- scroll screen up          PgDn -- scroll screen down
  104.   Home -- scroll screen to default position
  105.  
  106. Player 0 controls: CTRL -- fire, Use arrow keys to move.
  107. Player 1 controls:    n -- fire, s -- left, e -- up, f -- right, d -- down
  108.  
  109. Command Line Switches (put before filename)
  110.  
  111.  -0    -- player 0 hard, -1 -- player 1 hard
  112.  -r    -- run game at maximum speed
  113.  -r<n> -- run game at <n> frames per second (<n> = 1 - 254 inclusive)
  114.  -q    -- quiet (no sound)
  115.  -v<n> -- video mode (0=70Hz, 1=60Hz, 2=60Hz narrow, 3=60Hz 204 scan lines)
  116.  -j<n> -- joystick (0=joystick off, 1=normal, 2=players reversed)
  117.  
  118. More options and credits may be found in readme.txt.
  119.  
  120. Joystick
  121. --------
  122.  
  123. z26 automatically detects a PC joystick and uses it to emulate an Atari
  124. joystick if one is present. Calibration is not required. Just make sure
  125. the joystick is centered when the emulator is started. Button 1 is the
  126. fire button. The keyboard controls still work even if a joystick is
  127. present. To force keyboard only mode use the -j0 command line switch.
  128. Some games like raiders.bin use the "wrong" joystick.  To reverse the
  129. joysticks use the -j2 command line switch.
  130.  
  131.  
  132. Video Modes (correct play speed)
  133. --------------------------------
  134.  
  135. In order to provide good emulation of some of the Atari's more subtle
  136. graphics effects, z26 synchronizes game play with the refresh of the VGA
  137. screen. The original VGA video mode refreshes at 70Hz which makes game
  138. play slightly faster than a real Atari. By default, z26 uses a video
  139. mode that refreshes at 60Hz (Video Mode 3) to provide correct play
  140. speed. If you have a problem with this mode you may select the original
  141. 70Hz mode or one of the other modes with the -v<n> command line switch.
  142.  
  143.  
  144. Video Mode 0
  145. ------------
  146.  
  147. This is the original 70Hz mode 13 VGA mode.
  148.  
  149.  
  150. Video Mode 1
  151. ------------
  152.  
  153. This mode is full size on older fixed-frequency monitors but is usually
  154. somewhat shorter than normal on modern multi-frequency monitors.
  155. However, you may be able to adjust the controls of the monitor to get
  156. the correct height.
  157.  
  158.  
  159. Video Mode 2
  160. ------------
  161.  
  162. This mode is shorter and narrower than normal. If you can't, or don't
  163. wish to make an adjustment to your monitor to get Mode 1 looking right,
  164. or if you just like the smaller size better, you can use this mode to
  165. get the correct aspect ratio.
  166.  
  167.  
  168. Video Mode 3 (default)
  169. ----------------------
  170.  
  171. This mode is just like mode 2 except it has 4 additional scan lines for 
  172. a total of 204.  PCX screen capture will still only capture the first
  173. 200 scan lines.
  174.  
  175.  
  176. Are these video modes safe?
  177. ---------------------------
  178.  
  179. Of course I make no guarantees. But as far as I know they work almost
  180. everywhere that the original 70Hz mode 13 video mode works. If you find
  181. an exception please let me know. In any case, monitor damage seems
  182. unlikely. If you suspect a problem, press <esc> to restore your monitor
  183. to text mode, or just turn the monitor off.
  184.  
  185.  
  186. Adjusting Your Monitor
  187. ----------------------
  188.  
  189. If you have a modern multi-frequency monitor, one or more of these modes
  190. may require some adjustment to achieve a good appearance. Modern
  191. monitors often have the ability to save multiple settings for multiple
  192. video modes. So it MAY be possible to adjust these modes without
  193. disturbing the adjustments for your other display modes.
  194.  
  195.  
  196. Adjusting Vertical Position
  197. ---------------------------
  198.  
  199. You can scroll games up and down on the display with the <PgUp> and <PgDn>
  200. keys.  You can return to the default display position by pressing the
  201. <Home> key.  You can force the game to start displaying from a particular
  202. display line from the command line with the -u<n> command line option.
  203. The default starting line is 39.  So adjust from there.
  204.  
  205. Note that the <PgUp> and <PgDn> scrolling doesn't work for frogpond.bin
  206. or pharhcrs.bin.
  207.  
  208.  
  209. Forcing Black and White mode
  210. ----------------------------
  211.  
  212. You can force a game to start in black and white mode with the -b command
  213. line switch.
  214.  
  215.  
  216. Adjusting Game Speed
  217. --------------------
  218.  
  219. By default, games run at monitor speed.  If for some reason this doesn't
  220. work, or you want to try other speeds you can use the -r<n> command
  221. line switch.
  222.  
  223. If you don't specify a number <n> (-r) the game runs as fast as possible.
  224. Otherwise, it runs at <n> frames per second.  Normal speed is 60 frames
  225. per second.  Note that <n> must be between 1 and 254 inclusive.
  226.  
  227.  
  228. Measuring Emulator Performance
  229. ------------------------------
  230.  
  231. With the -f<n> option, you can run the emulator for <n> frames and the number
  232. of frames per second that the emulator ran at is printed out.  If you also
  233. specify the -r option to run at maximum speed you can see the maximum frame
  234. rate that the emulator can run a particular game at.  You can also do things
  235. like turning off joystick support and sound for maximum performance.
  236.  
  237.  
  238. Troubleshooting Sound Setup
  239. ---------------------------
  240.  
  241. If you run z26 and don't hear sound when you think you should, the first
  242. thing to check is to make sure the volume is turned up. If you're
  243. running under Windows 95, use the system volume control and make sure
  244. the Mute box is not checked. Also make sure the Wave Balance volume is
  245. turned up and that its Mute box is not checked. If you're running under
  246. DOS, use the volume control (mixer) program that came with your sound
  247. card.
  248.  
  249. Failing that, try running z26 with the -s (show sound diagnostic messages) 
  250. command line option.  Note that you must specify a filename with this option.
  251.  
  252. If you get the message "Sound Blaster too old!", maybe it's too old. You
  253. need a Sound Blaster with at least version 2.00 DSP to run z26.
  254.  
  255. If you get the message "Sound Blaster not found." then either you don't
  256. have a Sound Blaster, or there's a problem with the environment string.
  257. z26 expects you to have an environment string set with the configuration
  258. of your Sound Blaster. If you're running under Windows 95, this usually
  259. is not a problem because Windows 95 seems to set up the environment
  260. string automatically. If you're running under DOS, the environment
  261. string is usually set up during the Sound Blaster installation
  262. procedure.
  263.  
  264. To find out if your environment string has been set, type
  265.  
  266. >set
  267.  
  268. at the command line prompt.  Or type
  269.  
  270. >set | more
  271.  
  272. if there's too much information to display on a single screen.
  273.  
  274. You should see an entry something like this somewhere in the output:
  275.  
  276. BLASTER=A220 I10 D1 H7 P330 T6
  277.  
  278. If you don't, that's the problem. Otherwise the information in the
  279. environment string may not match the actual settings on your Sound
  280. Blaster. In either case, re-do the installation procedure for your sound
  281. card to correct the problem, or set up the environment string manually.
  282.  
  283.  
  284. More About Sound
  285. ----------------
  286.  
  287. z26 sound generation is based on the TIASound library by Ron Fries. 
  288. According to Ron, the optimum playback sample rate is 31400 samples per 
  289. second. This is the "natural frequency" of the Atari, the frequency at 
  290. which the sound generator in the Atari originally ran. So if your 
  291. Sound Blaster is capable of playing sound at this rate (and most modern
  292. Sound Blasters are), we use this rate. There are a few older Sound 
  293. Blasters that z26 supports that won't run at this rate. These Sound 
  294. Blasters are run at a rate of 15700 samples per second. This causes 
  295. only a small degradation in the quality of the sound.
  296.  
  297. We also generate sound in real time. This means we can use very small 
  298. sound buffers. This allows z26 to be more responsive to rapid changes 
  299. in the sound that some games call for. z26 currently uses a sound buffer
  300. of 256 bytes divided into two parts, giving it an effective buffer size 
  301. of 128 bytes.
  302.  
  303.  
  304. Digital Signal Processing
  305. -------------------------
  306.  
  307. z26 supports digital signal processing (DSP) on the sound. This is to
  308. reduce distortion on some clone sound cards, but also causes the sound
  309. to more closely approximate the sound of an old TV set for those users
  310. that prefer a more "classic" sound. To turn on DSP use the -d<n> command
  311. line switch. If n=1 the setting is low, if n=2 the setting is high.
  312.  
  313.  
  314. Offbeat Cartridge Formats (Bank Switching)
  315. ------------------------------------------
  316.  
  317. z26 currently supports the following schemes:
  318.  
  319. 1.  Standard 8K bank switching.
  320. 2.  Standard 16K bank switching.
  321. 3.  Atari Super-Chip.
  322. 4.  CBS Ram Plus.
  323. 5.  Parker Brothers 8K.
  324. 6.  TigerVision 8K.
  325. 7.  Activision FE 8K.
  326. 8.  Atari 32K.
  327. 9.  M-Network 16K.
  328.  
  329. Support is automatic.  z26 knows how to recognize cartridges.
  330.  
  331.  
  332. PCX Screen Capture
  333. ------------------
  334.  
  335. Pressing the = key during game play causes a .pcx file with a screen
  336. image to be placed in your directory. Filenames are z26p0000.pcx,
  337. z26p0001.pcx etc. The filename restarts at z26p0000.pcx causing old
  338. versions to be replaced each time you restart the emulator.
  339.  
  340.  
  341. Warranty
  342. --------
  343.  
  344. z26 is provided without a warranty of any kind, either express or
  345. implied. Neither John Saeger nor anyone who has worked on the code may
  346. be held responsible for any damages, either direct or consequential,
  347. caused by the use of z26. 
  348.  
  349.  
  350. Freeware
  351. --------
  352.  
  353. z26 is copyrighted freeware and may not be sold. Please keep all
  354. copyright notices and other acknowledgements intact. Thanks.
  355.  
  356.  
  357. Credits
  358. -------
  359.  
  360. z26 is based on A26 version 0.15 (C) 1996 by Paul Robson (autismuk@aol.com).
  361.  
  362. PCX screen capture is (C) 1997 by Ronnie Greene (ender@abts.net).
  363.  
  364. Atari 2600 sound emulation is based on TIASound (C) 1996 by Ron Fries.
  365.                                               (rfries@tcmail.frco.com)
  366.  
  367. 60Hz chained video modes courtesy of Jim Leonard (Trixter / Hornet).
  368.                                                 (trixter@hornet.org)
  369.  
  370. Sound drivers are based on Asteroids v3.02 (C) 1997 by Chris Pile.
  371.                                           (pegasus@enterprise.net)
  372.  
  373. 6507 CPU emulation based in part on 6510core.c by Ettore Perazzoli.
  374.                                                (ettore@comm2000.it)
  375.  
  376. Support for special cartridge formats based on information found in 
  377. sizes.txt by Kevin Horton (khorton@iquest.net).
  378.  
  379.  
  380. Thanks to everyone who has helped with comments, suggestions, bug
  381. reports, information, supplies and testing: 
  382.  
  383. Junky, Kevin White, The Boatwrights, Miguel Guzman Centeno, 
  384. Peter, Jay C. Heil, Zoop, Rob Anderson, Zophar, Peter Vogels, 
  385. Stephan, Xahji, Ricardo Martinez Garza, Stephano Camarri, 
  386. Peter Betz, Piero Cavina (Oystron! Helped find multiple missile bug.),
  387. Nick S. Bensema, Erik Mooney, Glenn Saunders, Abraham Velazquez, 
  388. Christian Schaefers (Z-Type), Freirias, Brian Deuel, Chris Platt,
  389. Israel Geron T., jose roberto rodrigues, Dan Meyer, Martin Schaefer,
  390. Ummagumma, Digitoxin, Michael Walden Jr. (The most elaborate suggestion 
  391. list!), Gilamonster, Gerald Gorman, Francisco Athens, Lex Nesta, Ben,
  392. Gerald Gray, Jose Pedro, Tadd Underhill, Ejber Ozkan, Lord Mhath,
  393. Larry Scott, Brad Komgenick, Michael J. Mika, Ettore Perazzoli (VICE), 
  394. Stephan Eder, Andreas Boose (VICE), David Gray, jimnav, 
  395. Dr. Simone Zanella, Brad Thomas, Jeff Cockayne, Sam Miller, EmrldSword,
  396. justin martin, Justin Scott, Jason Berk, Luis Graterol, Ricardo Soto,
  397. Brian Smith, Sam Hard, Keith Merizalde, Nate Marigoni, Kurt Woloch,
  398. GreenImp, M. C. Silvius, Matthew Conte (Nofrendo), Jason Barisoff, 
  399. Rick Vasquez, Marco Turconi, Kalik, Christopher Warren, Curt Vendel, 
  400. Roberto Sidney Teixeira, raverpup, iCeFiRe, Chism, Sascha Reuter,
  401. Craig Tildesley, Michael Prentler, Cody B, Thom Rechak, Cam, Jason,
  402. Keith Weisshar, Robin Gravel, Thom Bone, Mrfriend, Edwin Helsloot,
  403. C J Biro, Michael Monson, Justin Rodriguez, Francesco Azzurri,
  404. Greg Bendokus, Bruce Clarke, John Dullea (PCAE), Tim Boston,
  405. Chris Ainsley, Ricardo Henrique Tabone, and Seth Kintigh.
  406.  
  407. And thanks to Len Shikowitz for *complaining* well beyond the call of duty.
  408. Definitely "the most obstinate, yet sincere, tester." :)
  409.  
  410. And thanks to anyone I may have missed.
  411.  
  412.  
  413. Thanks!!!
  414.